home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 24 / AACD 24.iso / AACD / Online / Epic4 / share / epic / help / 6_functions / tdiff < prev    next >
Text File  |  2001-03-21  |  909b  |  26 lines
  1. Synopsis:
  2.    $tdiff(<seconds>)
  3.    $tdiff2(<seconds>)
  4.  
  5. Technical:
  6.    This converts an integer value to a human-readable string showing the
  7.    elapsed time in days, hours, minutes, and seconds.  The only difference
  8.    between the functions is that $tdiff2() is more compact.  Negative
  9.    numbers and decimals are permitted, though there probably isn't much use
  10.    for them.
  11.  
  12. Practical:
  13.    This function is useful for showing how much time has elapsed since a
  14.    particular event.  For instance, it can convert your idle time from the
  15.    number of seconds to a more readable form.
  16.  
  17. Returns:
  18.    human-readable string representing elapsed time
  19.  
  20. Examples:
  21.    $tdiff(248576)      returns "2 days 21 hours 2 minutes 56 seconds"
  22.    $tdiff2(248576)     returns "2d 21h 2m 56s"
  23.    $tdiff(-248576)     returns "-2 days -21 hours -2 minutes -56 seconds"
  24.    $tdiff2(-248576)    returns "-2d -21h -2m -56s"
  25.  
  26.